home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rbbsexe.zip / INSTALL.DOC < prev    next >
Text File  |  1992-06-21  |  17KB  |  314 lines
  1.  
  2.  
  3.  
  4.                    "Quick Start" for RBBS-PC, release 17.4
  5.  
  6.       I. What you'll need
  7.            To install RBBS-PC release 17.4, you'll need the following:
  8.  
  9.          - The REQUIRED .ZIP files for RBBS-PC:
  10.                 RBBS-EXE.ZIP - Executable files
  11.                 RBBS-TXT.ZIP - Text files
  12.                 RBBS-DOC.ZIP - RBBS-PC documentation.
  13.  
  14.          - A .ZIP extractor.   PKWare's  PKUNZIP version 1.1  or greater  is
  15.            recommended.
  16.  
  17.          - A  text editor capable of  editing and saving  text files WITHOUT
  18.            tabs.  A file browser may also come in handy.
  19.  
  20.          - At least 5 MegaBytes of free hard disk space.
  21.  
  22.       II. Getting started.
  23.  
  24.            Before you  begin, PRINT this  document.  Use the  [  ]  areas to
  25.            place checkmarks to record your progress.
  26.  
  27.  [  ]   A) Use  the DOS  MKDIR command  to create  a directory  for RBBS-PC.
  28.            RBBS-PC  can be  installed  on any  drive  or directory,  but  we
  29.            suggest you use: C:\RBBS.
  30.  
  31.            Record the directory name here: ______________________
  32.  
  33.  [  ]   B) Unzip ALL RBBS-PC files into this subdirectory.  If the files are
  34.            on a diskette in drive A:, use the following commands:
  35.  
  36.            C>  CD C:\RBBS       (directory recorded in step II.A)
  37.            C>  PKUNZIP -d A:*   (unzips files from first disk)
  38.  
  39.            Repeat this for each RBBS-PC diskette.
  40.  
  41.  [  ]   C) Run the RBBS-PC INSTALL program to check the files.  Type INSTALL
  42.            from  the C:\RBBS  directory.   If you  are missing  any REQUIRED
  43.            files  (look in  INSTALL.LOG  for results),  download the  proper
  44.            RBBS-PC distribution file.
  45.  
  46.  [  ]   D) Try the  system.  Type RBBS from the C:\RBBS directory.  You will
  47.            now be running your  RBBS-PC system in LOCAL mode.   When RBBS-PC
  48.            asks for your FIRST name, type:
  49.                 SECRET NAME
  50.  
  51.            This is  how the SysOp  logs onto a  BBS.  For  security reasons,
  52.            you'll NEVER  use your own name.   RBBS-PC will know  it's you by
  53.            your secret name.
  54.  
  55.            On the  first call, RBBS-PC won't know who  you are.  It will ask
  56.            you various questions, just as any new user would see.   Once you
  57.            answer the  questions, RBBS-PC will  display the  MAIN MENU,  and
  58.            recognize you as SysOp.  If you have a speaker on your PC, you'll
  59.            also here a few beeps.  That is RBBS-PC, telling the SysOp  a new
  60.            caller  just logged  in (a  feature that  can be  turned off,  of
  61.            course!)  Feel free to try out any RBBS-PC command in LOCAL mode,
  62.            so you will be familiar with the operation of RBBS-PC.
  63.  
  64.  
  65.  
  66.       III. Using CONFIG to Customize your system.
  67.  
  68.            Now that your  RBBS-PC is  installed, you will  begin the  never-
  69.            ending task of adding  personality to your system.   RBBS-PC does
  70.            not limit your  imagination, and  we encourage you  to make  your
  71.            RBBS-PC fit  your own taste and personality.  Only you can decide
  72.            what changes you will  make, but this next section will guide you
  73.            through the process of changing your system.
  74.  
  75.            Before we begin, consider this note about documentation.  RBBS-PC
  76.            comes  with two LARGE documentation  files.  You  may print these
  77.            files to make a technical reference book, but it may be easier to
  78.            use a file browse utility (such  as Vern Buerg's LIST program) to
  79.            search  for keywords  in the documentation.   Consider  the trees
  80.            (and the wear on your printer) before printing the docs!
  81.  
  82.  [  ]   A) Backup your RBBS-PC.DEF file.   This should ALWAYS be  your first
  83.            step  when  making  changes   to  RBBS-PC.    Many  configuration
  84.            parameters will  confuse you at  first, so  make sure you  have a
  85.            backup of RBBS-PC.DEF in case something goes wrong.
  86.  
  87.  [  ]   B) Run the  RBBS-PC  CONFIG utility.    This program  (discussed  in
  88.            chapter  10 of the RBBS-PC docs) is  how you make changes to your
  89.            RBBS-PC system.   The first set  of changes are required  to open
  90.            your RBBS-PC system, but you'll want to return to CONFIG any time
  91.            you  want to  "tune" your RBBS-PC.   To  start CONFIG,  go to the
  92.            C:\RBBS directory and type the command:
  93.  
  94.            C>  CONFIG RBBS-PC.DEF
  95.  
  96.  [  ]   C) Change the SysOp name.  Your RBBS-PC must know what your name is.
  97.            When the CONFIG  copyright screen  clears, press F1.   This  will
  98.            display the  first configuration screen.  Select parameter 1, and
  99.            CONFIG  will ask  for the  SysOp's FIRST  name.  Enter  your REAL
  100.            first name.  Select parameter 2 to enter your LAST name.
  101.  
  102.  [  ]   D) Change the name of your  BBS.  Select option 12, and  type in the
  103.            name you have chosen for your BBS.  Each time  someone calls your
  104.            BBS, RBBS-PC will welcome the caller by displaying this name.
  105.  
  106.  [  ]   E) Change your  SECRET name.  RBBS-PC's security  features depend on
  107.            secure  access to SysOp  functions.  For that  reason, NO ONE can
  108.            log into your  RBBS-PC with the  SysOp name (as  entered in  step
  109.            III.C.   When you want to log into your own BBS, you use a SECRET
  110.            name  that no one else  should know.  Try to  pick a name (or any
  111.            two words) that are SO STRANGE,  that no other person would guess
  112.            it.  Write your SECRET NAME below:
  113.  
  114.            ___________________________________________________________
  115.  
  116.            To enter this name,  press F7.  You  should see CONFIG  parameter
  117.            121  at the  top of  the screen.   The  default value  is "SECRET
  118.            NAME."  select parameter 121, and enter the name you chose.
  119.  
  120.  [  ]   F) Change the size  of the USER file.   Press F10.   On this screen,
  121.            select parameter 164.   This controls the  size of the  main USER
  122.            file.   Each new caller  to your RBBS-PC  needs a place  to store
  123.            their name, password, and other user information.   This consumes
  124.            128 bytes of hard disk space for each user.  Select a number that
  125.            you believe will suit  your needs (you  can come back and  change
  126.            your answer  at any time).  Note: CONFIG will always convert your
  127.  
  128.  
  129.  
  130.            selection to a  power of 2  (2, 4, 8,  16, 32,  64, etc).   After
  131.            CONFIG creates a new user file, it will ask if you wish to delete
  132.            the old user  file.  ALL current  users will be moved  to the new
  133.            user file, so you can delete the old one.
  134.  
  135.  [  ]   G) Change  the  size of  the MESSAGE  file.   Select  parameter 166.
  136.            Decide how  many messages you'll want  to store at any  time.  If
  137.            your callers enter  more than this  number without deleting  any,
  138.            RBBS-PC will not  allow new messages to be entered.   For new BBS
  139.            systems, 100 messages may be enough.  For very busy  systems, you
  140.            may need to increase this  (which can be done at any  time).  The
  141.            "MAX" value displayed represents how  many messages can be stored
  142.            without changing  the size of the  message file.  If  you enter a
  143.            number  greater  than the  MAX,  CONFIG will  determine  how many
  144.            "records" it  will need, and it  will ask if it  can increase the
  145.            message file accordingly.   Please answer YES.  CONFIG  will then
  146.            ask if you wish to delete the old message file, and you  may also
  147.            answer YES.
  148.  
  149.  [  ]   H) Exit CONFIG.  Press the END key on your keyboard  to exit CONFIG.
  150.            We want  to SAVE these  changes, so press  "Y" when asked  if you
  151.            wish to save the changes.
  152.  
  153.  [  ]   I) We can now test  the changes you just  made.  type RBBS  to start
  154.            your RBBS-PC.   Notice the welcome message?  It should be the one
  155.            you chose in step III.D, and should also display your name as the
  156.            SysOp.  Our first test will be a SysOp login attempt.  When RBBS-
  157.            PC asks  for your FIRST name,  type your REAL name  (the name you
  158.            entered  in CONFIG parameters 1  and 2).   RBBS-PC should respond
  159.            ACCESS  DENIED!  This  shows you that  no one can  try to use the
  160.            SysOp's name to gain access to your system.  Type RBBS again, and
  161.            we'll log on properly this time.  When asked for your FIRST name,
  162.            type your new SECRET  name (the one you recorded  in step III.E).
  163.            RBBS-PC will not know you by this name, so it will treat you like
  164.            a new user again.  Answer the new user questions,  and proceed to
  165.            the MAIN menu.
  166.  
  167.  [  ]   J) It's now time to do some SysOp maintenance.  The temporary SECRET
  168.            NAME is still on your system.   Now that you've invented your own
  169.            SysOp name, you should delete the old one.  From the RBBS-PC MAIN
  170.            MENU,  select option  5 (user maintenance).   You'll  see another
  171.            list of options - select M  (Modify user).  RBBS-PC will show you
  172.            the first user in the file.  If it's not SECRET NAME, we can tell
  173.            RBBS-PC to find that  user by selecting F (find),  and typing the
  174.            full name (SECRET NAME).  Once we have found SECRET NAME, we want
  175.            to DELETE the user, so press D.  RBBS-PC will ask if we are sure,
  176.            and we are.  Now that SECRET NAME is gone, no other RBBS-PC SysOp
  177.            can try to  use this name to gain illegal  access to your system.
  178.            As long  as you  protect your new  SysOp access  name, access  to
  179.            SysOp commands will be protected.
  180.  
  181.       You may  want to experiment with your new RBBS-PC system some more, or
  182.       move right on to the next step.
  183.  
  184.       IV. Configuring your modem.
  185.  
  186.       The next  step is the most  difficult task for  the new SysOp  - modem
  187.       installation.   RBBS-PC  must know  more about  your modem  than other
  188.       communications  software, because we do more  with your modem.  If you
  189.       make it past this step, consider yourself an experienced SysOp!
  190.  
  191.  
  192.  
  193.       First,  let's do a quick  check of your  modem's communications ports.
  194.       We'll use the DOS DEBUG command to do this.
  195.  
  196.  [  ]   A) From the DOS prompt, type DEBUG, and then: D 40:0 L 4
  197.            What you should see depends on if you have one or two modem ports
  198.            installed on your system.  If you see:
  199.  
  200.       0040:0000  F8 03 00 00
  201.  
  202.       Your computer has found one modem port - COM1.  If you see:
  203.  
  204.       0040:0000  F8 03 F8 02
  205.  
  206.       Your computer has found two modem ports - COM1 and COM2.  If you see:
  207.  
  208.       0040:0000  F8 02 00 00
  209.  
  210.       You have a problem.  The modem port in your computer was configured as
  211.       COM2, but it's the only one in the computer, so the computer has tried
  212.       to make it into COM1.  This will not work.  You'll have to reconfigure
  213.       your comm port (time to call your local computer dealer!).
  214.  
  215.       To exit DEBUG, type Q and press [ENTER].
  216.  
  217.       Before  you  configure   your  modem,  you'll  have   to  record  some
  218.       information  about  it.    Take  the  time  to  record  the  following
  219.       information:
  220.  
  221.  [  ]   B) Make/Model of modem: __________________________
  222.  
  223.  [  ]   C) Connected to which port (circle one):   COM1    COM2
  224.  
  225.  [  ]   D) Maximum speed of modem (circle one): 9600  2400  1200  300
  226.  
  227.       Now we'll use  CONFIG to describe  your modem to  RBBS-PC.  As  usual,
  228.       before running CONFIG,  you should make  a backup  copy of your  RBBS-
  229.       PC.DEF file.
  230.  
  231.  [  ]   E) Once you start CONFIG (remember  how?  Look at step  III.B), hold
  232.            the SHIFT key and press F2.  This brings us to the communications
  233.            screen.  Select option 221, and enter either 1 or 2, depending on
  234.            what COM port your modem is on (step IV.C).  If you don't want to
  235.            use a  modem, you can leave  option 221 set to  COM0, which means
  236.            RBBS-PC  will use the local keyboard and  screen.  If you want to
  237.            use  a port  other than  COM1  or COM2,  you will  need a  FOSSIL
  238.            driver.   Contact  your local  BBS  wizard for  information about
  239.            FOSSIL drivers.
  240.  
  241.  [  ]   F) Now select option 225 to set the modem commands RBBS-PC will  use
  242.            to  talk to  your modem.   The screen  you see  may be confusing.
  243.            Let's hope you never have to understand it.  At the bottom of the
  244.            screen  you'll see  a  menu of  choices -  select  0, which  will
  245.            present you with a list of modem  models.  If you don't see  your
  246.            modem listed on this  page, press 0  for the next  page.  If  you
  247.            still can't  find it, you may have to learn more about your modem
  248.            than you ever  dreamed.  If your modem  is a 2400 BPS  modem, and
  249.            not  on the  list,  select the  "Hayes  Compatible Generic  2400"
  250.            modem.  You could also contact your modem manufacturer and ask if
  251.            they  have the  proper RBBS-PC initialization  strings.   If not,
  252.            RBBS-PC  support will  configure  the modem  if the  manufacturer
  253.            sends a sample for testing.
  254.  
  255.  
  256.  
  257.  [  ]   G) Hopefully, your modem  was listed, and you selected it.  If there
  258.            are  any  physical switches  on  the modem,  the  required switch
  259.            positions were listed next to the name - check them.
  260.  
  261.  [  ]   H) To exit the parameter 225 menu, press ENTER.  CONFIG  will ask if
  262.            you wish  to set your modem's  firmware now.  Before  you can use
  263.            RBBS-PC  with your modem, you must do this, so now is a good time
  264.            (you  did turn  your modem ON,  didn't you?).     Answer YES, and
  265.            watch the screen.  You should  see the commands being sent to the
  266.            modem,  and the  modem should answer  OK.   If the  modem answers
  267.            ERROR,  we've hit a snag.   Recheck your  last few steps, consult
  268.            the RBBS-PC  documentation, and if  all else fails,  call RBBS-PC
  269.            support for advice.
  270.  
  271.  [  ]   I) Exit  CONFIG and save your changes.   RBBS-PC should now be ready
  272.            to accept calls.   Type RBBS, and  instead of seeing the  welcome
  273.            message, you should see RBBS-PC reset the modem and get ready for
  274.            calls.  After a  few seconds, the "ready for calls" screen should
  275.            display, letting you know  RBBS-PC is ready to answer  the phone.
  276.            You  can still log  on locally, either by  pressing the [ESC] key
  277.            from this screen, or by starting RBBS-PC with the command:
  278.                      RBBS LOCAL
  279.  
  280.       If  you don't  see  the "ready  for calls"  screen,  it usually  means
  281.       RBBS-PC can't talk to your  modem.  This could mean an  improper modem
  282.       cable was  used, or you missed  a step in the  modem configuration, or
  283.       the configuration  you selected  doesn't really work  (RBBS-PC support
  284.       hasn't checked all  modems -  some are supplied  by manufacturers  and
  285.       other SysOps).  Don't  panic if the "ready  for calls" screen  doesn't
  286.       appear.  As we said before, this is the hardest part of setting up the
  287.       RBBS-PC  system.    Double  check  the  setup,   consult  the  RBBS-PC
  288.       documentation, and if it still doesn't work, call RBBS-PC support.
  289.  
  290.       If the "ready for calls" screen does  appear, you can test your BBS by
  291.       calling it from  another computer.  The screen will  disappear after a
  292.       minute (automatic screen blanking feature).  The option keys described
  293.       on this screen are  important to the SysOp,  so you may want  to print
  294.       them out (the name of the file is MENU0, found in the RBBS-PC  default
  295.       directory).  Perhaps the most important is F9 (snoop).  Press this key
  296.       to see exactly what a caller is  doing online, and press again if  you
  297.       don't want to watch the caller.
  298.  
  299.       V. Register your System
  300.  
  301.  [  ] RBBS-PC registration just means you must spend some time filling out a
  302.       form,  and sending it  to RBBS-PC  support.  The  file is  in the TEXT
  303.       directory on your RBBS-PC system, and is called LG-9999.DEF.  Complete
  304.       instructions are in the file.
  305.  
  306.       Your RBBS-PC system  will probably demand  much more attention  before
  307.       you'll  want callers, but that is the fun of running a BBS.  The RBBS-
  308.       PC  documentation will describe all the features of RBBS-PC, but don't
  309.       try  to master them all at  once.  Be pateient,  and your RBBS-PC will
  310.       grow and improve daily.  If you ever need help, and you can't  seem to
  311.       find the answer, call the RBBS-PC technical support BBS at:
  312.                                 407-487-3441.
  313.  
  314.